Node / meshtastic / Meshtastic-Android / files / feature / firmware / src / commonMain / kotlin / org / meshtastic / feature / firmware / DefaultFirmwareUpdateManager.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tff7b72package T7ee787org.meshtastic.feature.firmware

Tff7b72import T7ee787org.koin.core.annotation.Single

Tff7b72import T7ee787org.meshtastic.core.common.util.CommonUri

Tff7b72import T7ee787org.meshtastic.core.database.entity.FirmwareRelease

Tff7b72import T7ee787org.meshtastic.core.model.DeviceHardware

Tff7b72import T7ee787org.meshtastic.core.repository.RadioPrefs

Tff7b72import T7ee787org.meshtastic.core.repository.isBle

Tff7b72import T7ee787org.meshtastic.core.repository.isSerial

Tff7b72import T7ee787org.meshtastic.core.repository.isTcp

Tff7b72import T7ee787org.meshtastic.feature.firmware.ota.Esp32OtaUpdateHandler

Tff7b72import T7ee787org.meshtastic.feature.firmware.ota.dfu.SecureDfuHandler

T8b949e/**

* Default [FirmwareUpdateManager] that routes to the correct handler based on the current connection type and device

* architecture. All handlers are KMP-ready and work on Android, Desktop, and (future) iOS.

*/

Tf0883e@Single

Tff7b72class T56d364DefaultFirmwareUpdateManagerTb4b4b4(

Tff7b72private Tff7b72val Te6edf3radioPrefsTb4b4b4: Te6edf3RadioPrefsTb4b4b4,

Tff7b72private Tff7b72val Te6edf3secureDfuHandlerTb4b4b4: Te6edf3SecureDfuHandlerTb4b4b4,

Tff7b72private Tff7b72val Te6edf3usbUpdateHandlerTb4b4b4: Te6edf3UsbUpdateHandlerTb4b4b4,

Tff7b72private Tff7b72val Te6edf3esp32OtaUpdateHandlerTb4b4b4: Te6edf3Esp32OtaUpdateHandlerTb4b4b4,

Tb4b4b4) Tb4b4b4: Te6edf3FirmwareUpdateManager Tb4b4b4{

Tff7b72override Tff7b72suspend Tff7b72fun Td2a8ffstartUpdateTb4b4b4(

Te6edf3releaseTb4b4b4: Te6edf3FirmwareReleaseTb4b4b4,

Te6edf3hardwareTb4b4b4: Te6edf3DeviceHardwareTb4b4b4,

Te6edf3addressTb4b4b4: Tffa657StringTb4b4b4,

Te6edf3updateStateTb4b4b4: Tb4b4b4(Te6edf3FirmwareUpdateStateTb4b4b4) Tff7b72-Tff7b72> Tffa657UnitTb4b4b4,

Te6edf3firmwareUriTb4b4b4: Te6edf3CommonUri?Tb4b4b4,

Tb4b4b4)Tb4b4b4: Te6edf3FirmwareArtifact? Tb4b4b4{

Tff7b72val Te6edf3handler Tff7b72= Te6edf3getHandlerTb4b4b4(Te6edf3hardwareTb4b4b4)

Tff7b72val Te6edf3target Tff7b72= Te6edf3getTargetTb4b4b4(Te6edf3addressTb4b4b4)

Tff7b72return Te6edf3handlerTb4b4b4.Te6edf3startUpdateTb4b4b4(

Te6edf3release Tff7b72= Te6edf3releaseTb4b4b4,

Te6edf3hardware Tff7b72= Te6edf3hardwareTb4b4b4,

Te6edf3target Tff7b72= Te6edf3targetTb4b4b4,

Te6edf3updateState Tff7b72= Te6edf3updateStateTb4b4b4,

Te6edf3firmwareUri Tff7b72= Te6edf3firmwareUriTb4b4b4,

Tb4b4b4)

Tb4b4b4}

Tff7b72override Tff7b72suspend Tff7b72fun Td2a8ffrecoverDfuDeviceTb4b4b4(

Te6edf3releaseTb4b4b4: Te6edf3FirmwareReleaseTb4b4b4,

Te6edf3hardwareTb4b4b4: Te6edf3DeviceHardwareTb4b4b4,

Te6edf3addressTb4b4b4: Tffa657StringTb4b4b4,

Te6edf3updateStateTb4b4b4: Tb4b4b4(Te6edf3FirmwareUpdateStateTb4b4b4) Tff7b72-Tff7b72> Tffa657UnitTb4b4b4,

Tb4b4b4)Tb4b4b4: Te6edf3FirmwareArtifact? Tff7b72=

T8b949e// Recovery is inherently a BLE DFU operation — route straight to the DFU handler rather than the

T8b949e// connection-type dispatch in getHandler(), which would fail with no live connection. The handler derives

T8b949e// MAC+1 from address and its buttonless trigger already no-ops when the device is already in DFU mode.

Te6edf3secureDfuHandlerTb4b4b4.Te6edf3startUpdateTb4b4b4(

Te6edf3release Tff7b72= Te6edf3releaseTb4b4b4,

Te6edf3hardware Tff7b72= Te6edf3hardwareTb4b4b4,

Te6edf3target Tff7b72= Te6edf3addressTb4b4b4,

Te6edf3updateState Tff7b72= Te6edf3updateStateTb4b4b4,

Te6edf3firmwareUri Tff7b72= Tff7b72nullTb4b4b4,

Tb4b4b4)

Tff7b72internal Tff7b72fun Td2a8ffgetHandlerTb4b4b4(Te6edf3hardwareTb4b4b4: Te6edf3DeviceHardwareTb4b4b4)Tb4b4b4: Te6edf3FirmwareUpdateHandler Tff7b72= Tff7b72when Tb4b4b4{

Te6edf3radioPrefsTb4b4b4.Te6edf3isSerialTb4b4b4(Tb4b4b4) Tff7b72-Tff7b72> Tb4b4b4{

Tff7b72if Tb4b4b4(Te6edf3hardwareTb4b4b4.Te6edf3isEsp32ArcTb4b4b4) Tb4b4b4{

Te6edf3errorTb4b4b4(Ta5d6ff"Ta5d6ffSerial/USB firmware update not supported for ESP32 devicesTa5d6ff"Tb4b4b4)

Tb4b4b4}

Te6edf3usbUpdateHandler

Tb4b4b4}

Te6edf3radioPrefsTb4b4b4.Te6edf3isBleTb4b4b4(Tb4b4b4) Tff7b72-Tff7b72> Tb4b4b4{

Tff7b72if Tb4b4b4(Te6edf3hardwareTb4b4b4.Te6edf3isEsp32ArcTb4b4b4) Tb4b4b4{

Te6edf3esp32OtaUpdateHandler

Tb4b4b4} Tff7b72else Tb4b4b4{

Te6edf3secureDfuHandler

Tb4b4b4}

Tb4b4b4}

Te6edf3radioPrefsTb4b4b4.Te6edf3isTcpTb4b4b4(Tb4b4b4) Tff7b72-Tff7b72> Tb4b4b4{

Tff7b72if Tb4b4b4(Te6edf3hardwareTb4b4b4.Te6edf3isEsp32ArcTb4b4b4) Tb4b4b4{

Te6edf3esp32OtaUpdateHandler

Tb4b4b4} Tff7b72else Tb4b4b4{

Te6edf3errorTb4b4b4(Ta5d6ff"Ta5d6ffWiFi OTA only supported for ESP32 devicesTa5d6ff"Tb4b4b4)

Tb4b4b4}

Tb4b4b4}

Tff7b72else Tff7b72-Tff7b72> Te6edf3errorTb4b4b4(Ta5d6ff"Ta5d6ffUnknown connection type for firmware updateTa5d6ff"Tb4b4b4)

Tb4b4b4}

Tff7b72internal Tff7b72fun Td2a8ffgetTargetTb4b4b4(Te6edf3addressTb4b4b4: Tffa657StringTb4b4b4)Tb4b4b4: Tffa657String Tff7b72= Tff7b72when Tb4b4b4{

Te6edf3radioPrefsTb4b4b4.Te6edf3isSerialTb4b4b4(Tb4b4b4) Tff7b72-Tff7b72> Ta5d6ff"Ta5d6ff"

Te6edf3radioPrefsTb4b4b4.Te6edf3isBleTb4b4b4(Tb4b4b4) Tff7b72-Tff7b72> Te6edf3address

Te6edf3radioPrefsTb4b4b4.Te6edf3isTcpTb4b4b4(Tb4b4b4) Tff7b72-Tff7b72> Te6edf3address

Tff7b72else Tff7b72-Tff7b72> Ta5d6ff"Ta5d6ff"

Tb4b4b4}

Tb4b4b4}